NAME¶

rlm_detail - FreeRADIUS Module

DESCRIPTION¶

The rlm_detail module writes radius packets to 'detail' files. It is primarily used for storing accounting information, but can be used in other sections to write packet details as well.

The file format is similar to that of the old Livingston servers, and many 'detail' file parsers should work with FreeRADIUS.

The main configuration items to be aware of are:

file

The file name in which to store the radius packet records. NOTE: this variable is run through dynamic string expansion, and can include FreeRADIUS variables to create a dynamic filename.

%{radacctdir}/%{Client-IP-Address}/detail-%Y%m

This will create one file per month, for each client.
This accomplishes 'file rotation' automatically from
within the server.

permissions

The file permissions of the file. If omitted, the default is 0600.

locking

This option is set to 'yes' or 'no'. By default it is 'no'. Set this to yes to enable file locking, which is used with the 'radrelay' program.

CONFIGURATION¶

modules {


  ...


  detail {


    filename = %A/%{Client-IP-Address}/detail-%Y%m


    permissions = 0600


    dir_permissions = 0755


    locking = no


  }


  ... 


}


  ...


accounting {


 ...


 detail


 ...


}

SECTIONS¶

authorization, accounting, pre_proxy, post_proxy, post_authentication

FILES¶

/etc/raddb/radiusd.conf

SEE ALSO¶

radiusd(8), radiusd.conf(5)

AUTHORS¶

Chris Parker, cparker@segv.org